schm-wms-sap-eapi
Shiseido Mule WMS 接口系统中文文档
接口描述: 通过Mulesoft接口完成WMS与SAP之间各种业务的数据传输
WMS调用：
UAT地址（测试环境）: https://schm-api-test.shiseido.cn/schm-wms-sap-eapi
PROD地址（生产环境）: https://schm-api.shiseido.cn/schm-wms-sap-eapi
SAP调用：
UAT地址（测试环境）: https://schm-api-test.shiseido.cn/schm-sap-wms-eapi
PROD地址（生产环境）: https://schm-api.shiseido.cn/schm-sap-wms-eapi
目录
- 1 身份认证
- 2 接口列表
- 3 接口调用说明
- 3.1 4063,4539,4541,5741,8685,由WMS到SAP
- 3.2 3919,由WMS到SAP
- 3.3 4048,4546,4547,5743,8688,由WMS到SAP
- 3.4 4053,4562,4563,5742,8687,由WMS到SAP
- 3.5 4061,4529,4531,5739,8682,由WMS到SAP
- 3.6 4064,4543,4544,由WMS到SAP
- 3.7 4197,4510,4511,5745,由WMS到SAP
- 3.8 4052,4559,4560,5738,8681,由SAP到WMS
- 3.9 4060,4524,4525,5813,8419,由SAP到WMS
- 3.10 4062,4600,4535,5740,8683,由SAP到WMS
- 3.11 4196,4508,4509,5744,由SAP到WMS
- 3.12 4054,4571,4572,由SAP到WMS
- 3.13 4050,4552,4554,由SAP到WMS
1.身份认证
所有请求头必须包含以下键值参数作为身份验证信息。您需要向管理员申请这些信息。
client_id: fa98****3452
client_secret: 108b****41f2
2.接口总览:
接口使用方：WMS
| 仓库场景 | 业务含义 | 业务代码 | 请求接口地址 |
|---|---|---|---|
| 采购（仓库间移入） | Inbound GR confirmation | 4061 | /inboundGRConfirmation |
| 采退（仓库间移出） | Outbound Delivery PGI | 4063 | /outboundDeliveryPGI |
| 库内转储 | Stock movements | 4053 | /stockMovementIn |
| 盘点 | Stock count results to SAP | 4197 | /stockCountResult |
| 库存核对 | Stock on hand to SAP | 4048 | /stockBalance |
| 委外 | GR for Subcontract PO | 4064 | /GRforSubconPO |
| POD | 3919 | /pod |
接口使用方：SAP
| 仓库场景 | 业务含义 | 业务代码 | 请求接口地址 |
|---|---|---|---|
| 采购（仓库间移入） | Inbound Delivery | 4060 | /inboundDelivery |
| 采退（仓库间移出） | Outbound Delivery | 4062 | /outboundDelivery |
| 盘点 | Stock count document | 4196 | /stockDocument |
| 委外 | Subcontract PO | 4050 | /subcontractPO |
| Batch Master Data | 4052 | /batch | |
| 库内转储 | Stock Movement Outbound | 4054 | /stockMovement |
完整调用地址为对应环境地址+接口地址，如测试环境调用 outboundDeliveryPGI 传输4063数据内容，则接口调用地址为：
https://schm-api-test.shiseido.cn/schm-wms-sap-eapi/outboundDeliveryPGI
3.接口调用说明
3.1 WMS to SAP: 采购（仓库间移入） 4061 Inbound GR confirmation
请求接口: /inboundGRConfirmation
接口描述: WMS 采购（仓库间移入）
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_InboundGRConfirmation": {
"FileName": "4000004061_7855_20221221111505320_2104.xml",
"IBDGR": {
"BUDAT": "20221221",
"GM_CODE": "01",
"Item": [{
"VBELN": "4100642547",
"COSNR": "000010",
"MATNR": "10116152801",
"WERKS": "7855",
"LGORT": "W007",
"ERFMG": "1002",
"ERFME": "EA",
"CHARG": "COMMON",
"EXPIRYDATE": null,
"PRODDATE": null,
"MOVETYPE": "109",
"STOCKTYPE": null,
"MOVEFLG": "B",
"BELNR": "4570014383",
"VGPOS": "00010"
}]
}
}
}3.2 WMS to SAP: 采退（仓库间移出） 4063 Outbound Delivery PGI
请求接口: /outboundDeliveryPGI
接口描述: WMS 采退（仓库间移出）
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_OutboundDeliveryPGI": {
"FileName": "4000004063_7855_20220701132305570.xml",
"OBDPGI": {
"VBELN": "4500019792",
"ISDD": "20220627",
"QualifierDate": "006",
"QualifiePGI": "PGI",
"QualifiePIC": "PIC",
"QualifieCHG": "CHG",
"Item": [{
"POSNR": "000010",
"MATNR": "10103954202CN",
"CHARG": "2622AA",
"WERKS": "7855",
"AdmQnty": "10",
"LGORT": "W001",
"MEINS": "EA",
"HIPOS": "0",
"Controlling": {
"QualifierType": "QUA"
}
}]
}
}
}3.3 WMS to SAP: 库内转储 4053 Stock movements
请求接口: /stockMovementIn
接口描述: WMS 库内转储
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_StockMovementInbound": {
"FileName": "4000004053_7855_20221219161001040_2099.xml",
"DocHead": {
"BLDAT": "20221219",
"BUDAT": "20221219",
"XBLNR": null,
"TCODE": "MIGO",
"DocItem": [{
"MATNR": "10116152801",
"WERKS": "7855",
"LGORT": "W007",
"CHARG": "2214DD",
"BWART": "541",
"SOBKZ": null,
"ERFMG": "3000",
"ERFME": "EA",
"EBELN": "0458018717",
"EBELP": "00010",
"UMWRK": "7855",
"UMLGO": "W007",
"UMCHA": "2214DD",
"GRUND": null,
"MHDAT": "20220802",
"VFDAT": "20250802",
"KOSTL": null,
"POSNR": "00010",
"VBELN": null,
"SGTXT": null
}]
}
}
}3.4 WMS to SAP: 盘点 4197 Stock count results to SAP
请求接口: /stockCountResult
接口描述: WMS 盘点
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_StockCountResult": {
"FileName": "4000004197_7855_20221223104943560_2129.xml",
"DocHead": {
"IBLNR": "0100017539",
"GJAHR": "2022",
"DZLDAT": "20221219104943",
"DocItem": [{
"DZEILE": "1",
"MATNR": "15141410101CN",
"CHARG": "2510",
"ERFMG": "3000",
"ERFME": "EA",
"XNULL": null
}]
}
}
}3.5 WMS to SAP: 库存核对 4048 Stock on hand to SAP
请求接口: /stockBalance
接口描述: WMS 库存核对
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_StockBalance": {
"FileName": "4000004048_7855_20221212040109686_2083.xml",
"RPHead": {
"Reference": "7855121204010984",
"ERSDA": "20221212",
"CPUTM": "040109",
"RPItem": [
{
"MATNR": "10110446201CN",
"WERKS": "7855",
"LGORT": "W007",
"CHARG": "2410",
"VFDAT": "20220930",
"MEINS": "EA",
"CLABS": "42",
"STATUS": "Unrestricted"
},
{
"MATNR": "10110446201CN",
"WERKS": "7855",
"LGORT": "W007",
"CHARG": "2509",
"VFDAT": "20230901",
"MEINS": "EA",
"CLABS": "58038",
"STATUS": "Unrestricted"
},
{
"MATNR": "10110446201CN",
"WERKS": "7855",
"LGORT": "W007",
"CHARG": "2709",
"VFDAT": "20250831",
"MEINS": "EA",
"CLABS": "38080",
"STATUS": "Unrestricted"
}
]
}
}
}3.6 WMS to SAP: 委外 4064 GR for Subcontract PO
请求接口: /GRforSubconPO
接口描述: WMS 委外
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_GRforSubconPO": {
"FileName": "4000004064_7855_20221222100014966_2120.xml",
"POGR": {
"BUDAT": "20221222",
"BLDAT": "20221222",
"HEADER_TXT": null,
"GRGI_NO": null,
"BILL_OF_LADING": null,
"GM_CODE": "01",
"Item": [
{
"MATNR": "10116152801",
"WERKS": "7855",
"LGORT": "W007",
"ERFMG": "960",
"ERFME": "EA",
"CHARG": "2194QD",
"VFDAT": "20250713",
"MHDAT": "20220713",
"BWART": "543",
"SPEC_STOCK": "O",
"MVT_IND": null,
"EBELN": "0458029926",
"EBELP": "00010",
"LIFNR": "2100003636",
"LINE_ID": null,
"HIPOS": "00010",
"SGTXT": null
},
{
"MATNR": "10116152801",
"WERKS": "7855",
"LGORT": "W007",
"ERFMG": "42",
"ERFME": "EA",
"CHARG": "2200SD",
"VFDAT": "20250719",
"MHDAT": "20220719",
"BWART": "543",
"SPEC_STOCK": "O",
"MVT_IND": null,
"EBELN": "0458029926",
"EBELP": "00010",
"LIFNR": "2100003636",
"LINE_ID": null,
"HIPOS": "00020",
"SGTXT": null
},
{
"MATNR": "10116152801CN",
"WERKS": "7855",
"LGORT": "W007",
"ERFMG": "960",
"ERFME": "EA",
"CHARG": "2194QD",
"VFDAT": "20250713",
"MHDAT": "20220713",
"BWART": "101",
"SPEC_STOCK": null,
"MVT_IND": "B",
"EBELN": "0458029926",
"EBELP": "00010",
"LIFNR": "2100003636",
"LINE_ID": "00010",
"HIPOS": null,
"SGTXT": null
},
{
"MATNR": "10116152801CN",
"WERKS": "7855",
"LGORT": "W007",
"ERFMG": "42",
"ERFME": "EA",
"CHARG": "2200SD",
"VFDAT": "20250719",
"MHDAT": "20220719",
"BWART": "101",
"SPEC_STOCK": null,
"MVT_IND": "B",
"EBELN": "0458029926",
"EBELP": "00010",
"LIFNR": "2100003636",
"LINE_ID": "00020",
"HIPOS": null,
"SGTXT": null
}
]
}
}
}3.7 WMS to SAP: 对3919数据由WMS传输至SAP 3919 POD
请求接口: /pod
接口描述: WMS 对3919数据由WMS传输至SAP
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_POD": {
"FileName": "4000003919_7857_20221226-190211-480.XML",
"PODHead": {
"ProofDate": "20221215",
"ProofTime": "023502",
"VBELN": "4402842948",
"PODItem": [
{
"POSNR": "000010",
"AdmQnty": "4",
"MATNR": "10215283803CN",
"ORKTX": "怡丽丝尔 优悦活颜 柔滑弹润水(滋润型)",
"CHARG": "2507"
},
{
"POSNR": "000020",
"AdmQnty": "4",
"MATNR": "10215282803CN",
"ORKTX": "怡丽丝尔 优悦活颜 柔滑弹润水(清爽型)",
"CHARG": "2506"
},
{
"POSNR": "000030",
"AdmQnty": "4",
"MATNR": "10115229801CN",
"ORKTX": "怡丽丝尔 优悦活颜 柔滑防护精华乳 SPF50+ PA++++",
"CHARG": "2410"
},
{
"POSNR": "000040",
"AdmQnty": "4",
"MATNR": "10116858801CN",
"ORKTX": "怡丽丝尔 蕴能凝时 三重防护隔离乳",
"CHARG": "2406",
"Variance": {
"GRUND": "DFG2",
"LFIMG_DIFF": "1",
"VRKME": "EA",
"PODMG": "3"
}
},
{
"POSNR": "000050",
"AdmQnty": "4",
"MATNR": "10118888801CN",
"ORKTX": "怡丽丝尔 纯肌净白 集中淡斑精华液",
"CHARG": "2408"
},
{
"POSNR": "000060",
"AdmQnty": "4",
"MATNR": "10118350801CN",
"ORKTX": "怡丽丝尔 优悦活颜 眼唇抚纹遮瑕精华霜",
"CHARG": "2409"
}
]
}
}
}3.8 SAP to WMS: 采购（仓库间移入） 4060 Inbound Delivery
请求接口: /inboundDelivery
接口描述: SAP 采购（仓库间移入）
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_InboundDelivery": {
"FileName": "4000004060_7855_20230110182029_67fecf8d90d011ed9b12000006277758.xml",
"IBDHead": {
"InStcNo": "4100702874",
"AUART": "Z4EL",
"AdmYMD": "20230101",
"SAP_VENDORCODE": "0A10000001",
"SAP_VENDORNAME": "SHISEIDO CO., LTD.",
"SAP_COUNTRY": "JP",
"BOLNR": "785C253/22",
"InvoiceNo": "785C253/22",
"IBDItem": [
{
"COSNR": "000010",
"SAPPRODUCTCD": "1018X192000",
"DESCRIBE": "JGA.AN PUV SS SC MILK A PP 4ML",
"CHARG": "COMMON",
"PLACECD": "7855",
"LGORT": "W007",
"InQnty": "1320000.000",
"VRKME": "EA",
"BELNR": "4570015393",
"VGPOS": "000030",
"BWART": "109"
},
{
"COSNR": "000020",
"SAPPRODUCTCD": "1018Y734000",
"DESCRIBE": "JGA.AN DAY SERUM 6ML",
"CHARG": "COMMON",
"PLACECD": "7855",
"LGORT": "W007",
"InQnty": "470000.000",
"VRKME": "EA",
"BELNR": "4570015393",
"VGPOS": "000040",
"BWART": "109"
}
]
}
}
}3.9 SAP to WMS: 采退（仓库间移出） 4062 Outbound Delivery
请求接口: /outboundDelivery
接口描述: SAP 采退（仓库间移出）
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_OutboundDelivery": {
"FileName": "4000004062_7855_20230106121020_08e4c7fb8d7811ed9d34000006ab72d7.xml",
"OBDHead": {
"OutStcNo": "4500085836",
"ShippingCondition": "01",
"AUART": "Z4NL",
"AdmYMD": "20230106",
"QUALF": "006",
"QUALIFIER": "ORI",
"SAP_LOCATION1": "3F-8F LJZ FINANCIAL PLAZA",
"SAP_PARVW_D": "WE",
"DELIVERADDCD": "0A78500001",
"DELIVERADDNM": "Shiseido China Co., Ltd.",
"DELIVERADD1": "3F-8F LJZ FINANCIAL PLAZA",
"DELIVERADD2": "826 CENTURY AVENUE",
"AREANM_D": "SHANGHAI",
"SAP_POSTCD_D": "200120",
"SAP_COUNTRY_D": "CN",
"SAP_SALESORGANIZATION_D": "7851",
"SAP_SALESORGANIZATION_P": "7851",
"OUTPUTTYPE": "Z4OD",
"OBDItem": [
{
"LineNo": "000010",
"SAPPRODUCTCD": "15142520101CN",
"PLACECD": "7855",
"ActualQty": "1002.000",
"LGORT": "W001",
"VRKME": "EA",
"SAP_DISTRIBUTIONCHANNEL": "16",
"PSTYV": "NLN",
"MoveType": "641"
},
{
"LineNo": "000020",
"SAPPRODUCTCD": "15143117101CN",
"PLACECD": "7855",
"ActualQty": "1634.000",
"LGORT": "W001",
"VRKME": "EA",
"SAP_DISTRIBUTIONCHANNEL": "16",
"PSTYV": "NLN",
"MoveType": "641"
},
{
"LineNo": "000030",
"SAPPRODUCTCD": "15143315101CN",
"PLACECD": "7855",
"ActualQty": "5001.000",
"LGORT": "W001",
"VRKME": "EA",
"SAP_DISTRIBUTIONCHANNEL": "16",
"PSTYV": "NLN",
"MoveType": "641"
},
{
"LineNo": "000040",
"SAPPRODUCTCD": "15143316101CN",
"PLACECD": "7855",
"ActualQty": "2001.000",
"LGORT": "W001",
"VRKME": "EA",
"SAP_DISTRIBUTIONCHANNEL": "16",
"PSTYV": "NLN",
"MoveType": "641"
},
{
"LineNo": "000050",
"SAPPRODUCTCD": "15143374101CN",
"PLACECD": "7855",
"ActualQty": "1000.000",
"LGORT": "W001",
"VRKME": "EA",
"SAP_DISTRIBUTIONCHANNEL": "16",
"PSTYV": "NLN",
"MoveType": "641"
}
]
}
}
}3.10 SAP to WMS: 盘点 4196 Stock count document
请求接口: /stockDocument
接口描述: SAP 盘点
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_StockCountDocument": {
"FileName": "4000004196_7857_20230206092551_319899cda5bd11ed8897000006277757.xml",
"DocHead": {
"StcDoc": "0100018595",
"FiscalYear": "2023",
"CALDATE": "20230206",
"PlaceCD": "7857",
"LGORT": "W999",
"DocItem": [
{
"LineNo": "001",
"SAPPRODUCTCD": "34501753101CN",
"CHARG": "2252",
"MEINS": "EA",
"StockType": "1",
"DESCRIBE": "TOA TOA LRSP_PRESSE SHADE1"
},
{
"LineNo": "002",
"SAPPRODUCTCD": "34501613101CN",
"CHARG": "2243SG",
"MEINS": "EA",
"StockType": "1",
"DESCRIBE": "GWP INAPROP RED TOA SHADE1"
},
{
"LineNo": "003",
"SAPPRODUCTCD": "85066100102CN",
"CHARG": "2230K9",
"MEINS": "EA",
"StockType": "1",
"DESCRIBE": "NR FHPM EDP-20-(x12) SOFIX 0,8ML"
},
{
"LineNo": "004",
"SAPPRODUCTCD": "1018X191000CN",
"CHARG": "2221ED",
"MEINS": "EA",
"StockType": "1",
"DESCRIBE": "JGA.AN PUV SS SC MILK A 12ML"
}
]
}
}
}3.11 SAP to WMS: 委外 4050 Subcontract PO
请求接口: /subcontractPO
接口描述: SAP 委外
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_SubcontractPO": {
"FileName": "4000004050_7855_20220725153700_91ae73a00bec11ed894500000078ed3a.xml",
"POHead": {
"InvoiceNo": "0458014623",
"CompanyCD": "785",
"BSART": "Z410",
"AEDAT": "20220721",
"PARTN": "2100000713",
"EKORG": "2001",
"ORGID": "253",
"CURCY": "CNY",
"DocumentDate": "20220721",
"POItem": [
{
"VGPOS": "00010",
"ItemCategory": "3",
"HEADERPRODUCTCD": "34101225101CN",
"ShortText": "NARS 亮采柔滑遮瑕膏 奶咖色",
"PlaceCd": "7855",
"LGORT": "W007",
"ImportQnty": "1000.000",
"MENEE": "EA",
"PriceUnit": "1",
"EAN11": "607845012252",
"Component": {
"HIPOS": "00010",
"POSNR": "0001",
"ITEMPRODUCTCD": "34101225101",
"RequireQnty": " 1000.000",
"MEINS": "EA",
"SHKZG": "H"
}
},
{
"VGPOS": "00020",
"ItemCategory": "3",
"HEADERPRODUCTCD": "34170828102CN",
"PlaceCd": "7855",
"LGORT": "W007",
"ImportQnty": "1000.000",
"MENEE": "EA",
"PriceUnit": "1",
"EAN11": "607845708285",
"Component": {
"HIPOS": "00020",
"POSNR": "0001",
"ITEMPRODUCTCD": "34170828102",
"RequireQnty": " 1000.000",
"MEINS": "EA",
"SHKZG": "H"
}
}
]
}
}
}3.12 SAP to WMS: 4052 Batch Master Data
请求接口: /batch
接口描述: SAP Batch master data from S4 to 3PL WMS.
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_BatchMaster": {
"FileName": "4000004052_7855_20221209164328_8d47b563779d11edb29b00000078ed3a.xml",
"BatchMaster": [{
"SAPPRODUCTCD": "10115234801CN",
"PlaceCD": "7855",
"CHARG": "2503",
"EXPIRYDATE": "20250301",
"PRODDATE": "20220301",
"AvailableDate": "20221001"
}]
}
}3.13 SAP to WMS: 库内转储 4054 Stock Movement Outbound
请求接口: /stockMovement
接口描述: SAP 库内转储
请求类型: HTTP POST
请求参数示例
{
"MT_SCH_WMS_StockMovementOutbound": {
"FileName": "4000004054_7855_20230627142420_4033b81a14b311eebdf8000006ab72d8.xml",
"DocHead": {
"DocDate": "20230627",
"PostingDate": "20230627",
"CreateDate": "20230627",
"CreateTime": "022417",
"ProDoc": "5002838448",
"ProDocYear": "2023",
"DocItem": [
{
"Lineno": "0001",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "87.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1175L1",
"MoveType": "343"
},
{
"Lineno": "0003",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "19.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1176M1",
"MoveType": "343"
},
{
"Lineno": "0005",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "160.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1190R1",
"MoveType": "343"
},
{
"Lineno": "0007",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "118.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1193T1",
"MoveType": "343"
},
{
"Lineno": "0009",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "161.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1257G1",
"MoveType": "343"
},
{
"Lineno": "0011",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "213.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1330M1",
"MoveType": "343"
},
{
"Lineno": "0013",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "43.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1333N1",
"MoveType": "343"
},
{
"Lineno": "0015",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "39.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1350P1",
"MoveType": "343"
},
{
"Lineno": "0017",
"SAPPRODUCTCD": "15143244101CN",
"Qnty": "7.000 ",
"ERFME": "EA",
"Placecd": "7855",
"LGORT": "W005",
"CHARG": "1351Q1",
"MoveType": "343"
}
]
}
}
}4.接口返回说明
4.1 正常返回
{
"status": "success"
}4.2 非正常返回
{
"status": "false",
"message": "error description"
}